home *** CD-ROM | disk | FTP | other *** search
/ TOS Silver 2000 / TOS Silver 2000.iso / Tools / RSCVIEW / RSCVIEW.STG < prev    next >
Encoding:
Text File  |  1997-04-02  |  13.4 KB  |  332 lines
  1. ##ACE-STGPAR 4 0004 
  2. @database "RscView Dokumentation"
  3. @subject "Dokumentation/Sonstige"
  4. @author "Holger Weets"
  5. @$VER: RscView.hyp (@:"__DATE__")
  6. @options +gz-s-d12
  7.  
  8. @node Main "RscView"
  9. @{U}Inhaltsverzeichnis                                                    RscView@{0}
  10.  
  11. @limage rscview.img 0 solid
  12.  
  13. @{U}Inhalt:@{0}
  14. · Installation
  15. · Wofür isses?
  16. · Voraussetzungen
  17. · Das unvermeidbare Kapitel
  18. · Hinweise
  19.  
  20. · Tastatur-Kommandos
  21. · Maus-Kommandos
  22.  
  23. · History
  24. @endnode
  25.  
  26. @node "Installation"
  27. @{U}Installation                                                          RscView@{0}
  28.  
  29. Die Installation gestaltet sich denkbar einfach:
  30.  
  31. 1. RscView.app in einen beliebigen Ordner entpacken
  32. 2. RscView.hyp in den Guides-Ordner des ST-Guide entpacken
  33. 3. Bei Bedarf RscView im Desktop als Anwendung für *.RSC anmelden
  34.  
  35. Fertig.
  36. @endnode
  37.  
  38. @node "Wofür isses?"
  39. @{U}Wofür isses?                                                          RscView@{0}
  40.  
  41. In erster Linie ist RscView ein Anzeigeprogramm für RSC-Files, und zwar
  42. insbesondere auch für Anwender mit RSC-Editor, da RscView schneller ge-
  43. laden ist und ein einfaches Durchblättern der Resourcen ermöglicht.
  44.  
  45. Außerdem eignet sich RscView recht gut zum Verändern fremder RSC-Files
  46. und ist daher insbesondere für Anwender geeignet, die nicht über einen
  47. entsprechenden RSC-Editor verfügen, aber trotzdem z.B. das Resourcefile
  48. von Cat an ihre Bedürfnisse anpassen, dafür aber nicht extra einen teuren
  49. Editor anschaffen wollen...
  50. ...mit RscView können Menue-Shortcuts geändert und Buttons umsortiert
  51. werden, Dialoge werden tastaturbedienbar, langweilige Buttons werden
  52. zu hübschen Ankreuzknöpfen, schwarzweiß-Resourcen werden farbenfroh
  53. und vieles mehr.
  54. @endnode
  55.  
  56.  
  57. @node "Voraussetzungen"
  58. @{U}Voraussetzungen                                                       RscView@{0}
  59.  
  60. RscView verwendet ausschließlich Funktionen des Betriebsystems.
  61. Das bedeutet insbesondere, daß Resourcefiles mit Farb-Icons nur unter
  62. Betriebsystemen geladen/angezeigt werden, die dieses Feature auch
  63. anbieten,  und daß die Reaktion eines Systemes ohne Farb-Icon Unterstützung
  64. auf den Versuch, ein entsprechendes RSC-File zu laden, undefiniert ist.
  65.  
  66. Am wohlsten fühlt sich RscView unter MagiC, da verschiedene Features
  67. dieses Systemes genutzt werden (Checkboxes, scrollende Editfelder etc),
  68. der eigentliche Viewer läuft aber uneingeschränkt unter jedem System,
  69. lediglich die Editor-Dialoge werden ggf. ein gewöhnungsbedürftiges Outfit
  70. haben.
  71.  
  72. Die im Editor-Dialog verwendeten Popups funktionieren nur unter MagiC und
  73. neueren N.AES Versionen (an dieser Stelle nochmal Danke an Patrick Jerchel
  74. für die Einsicht und den Einbau von form_popup() in N.AES :-)
  75. Unter TOS und hier nicht genannten Systemen funktionieren die Popups nur,
  76. wenn eine aktuelle Version von WDialog installiert ist.
  77.  
  78. Die Objekte im Editor-Dialog sind tastaturbedienbar, sofern entweder
  79. MagiC oder Let 'em Fly läuft.
  80.  
  81. RscView freut sich (wie alle meine Programme) über einen AV-Server, nimmt
  82. an dessen Window-Cycling teil, reicht nicht verarbeitete Tastendrücke an
  83. diesen weiter, nimmt RSC-Files auch per D&D an und unterstützt Quoting,
  84. hat also keine Probleme mit Leerzeichen in Dateinamen, sofern der ver-
  85. wendete Desktop damit ebenfalls zurechtkommt.
  86.  
  87. @endnode
  88.  
  89. @node "Das unvermeidbare Kapitel"
  90. @{U}Rechtliches                                                           RscView@{0}
  91.  
  92. @{B}Als reines Anzeigeprogramm eingesetzt ist RscView Freeware, d.h.
  93. jeder kann es unbegrenzt lange kostenlos benutzen.@{0}
  94.  
  95. Wer RscView jedoch zum Verändern von RSC-Files verwenden will, der wird
  96. nicht umhin kommen, sich einen Schlüssel bei mir zu besorgen, denn ohne
  97. diesen wird RscView die Änderungen am RSC-File nicht abspeichern.
  98.  
  99. Die Sharegebühr in Höhe von 10,- DM kann geschickt werden an:
  100.     Holger Weets
  101.     Tangastr. 45
  102.     26121 Oldenburg
  103.  
  104. oder überwiesen werden:
  105.  
  106.     Konto: 1776764
  107.     BLZ  : 380 707 24
  108.     Bank 24
  109.  
  110. Ich kann natürlich nicht haftbar gemacht werden für Schäden jedwelcher
  111. Art, die durch die Benutzung von RscView entstehen könnten, die
  112. Verwendung dieser Software erfolgt also vollständig auf eigenes Risiko.
  113. Mit dem ersten Start des Programmes wird dies anerkannt.
  114.  
  115. Für den Vertrieb von RscView in PD-Serien oder auf CDs wird mein Einver-
  116. ständnis benötigt, sofern der Erwerb des entsprechenden Mediums den
  117. Selbstkostenpreis übersteigt. Derzeit hat @{B}kein@{0} "PD-Vertrieb"
  118. mein Einverständnis.
  119. @endnode
  120.  
  121. @node "Tastatur-Kommandos"
  122. @{U}Tastatur-Kommandos                                                    RscView@{0}
  123.  
  124. Cursortasten        Fensterinhalt in die entsprechende Richtung scrollen
  125. Shift Cursortasten  Fensterinhalt seitenweise in die entsprechende
  126.                     Richtung scrollen
  127. Home                linke obere Ecke des Dialoges ins Fenster scrollen
  128. Space               Fenstergröße an die des Dialoges anpassen
  129. @symbol i "Laden"
  130. CTRL-O              neue RSC-Datei per Fileselektor laden
  131. @symbol i "Speichern"
  132. CTRL-S              Änderungen am RSC-File sichern
  133. CTRL-U              Fenster schließen, RscView beenden
  134. CTRL-Q              Fenster schließen, RscView beenden
  135. @symbol i "Suchen"
  136. CTRL-F              RSC-File nach einer Zeichenkette durchsuchen
  137. CTRL-G              Zeichenkette erneut suchen
  138. Help                diesen Hypertext anzeigen lassen
  139. Esc                 Fensterinhalt neu darstellen
  140. CTRL-I              Info-Dialog, Registrierung
  141. @symbol i "Blättern"
  142. CTRL-Cursor-Rechts
  143. Ziffernblock +      nächsten Dialog zeigen (zyklisch)
  144. CTRL-Cursor-Links
  145. Ziffernblock -      vorigen Dialog zeigen (zyklisch)
  146. @endnode
  147.  
  148. @node "Maus-Kommandos"
  149. @{U}Maus-Kommandos                                                        RscView@{0}
  150.  
  151. Einfachklick        Markiert das Objekt unter der Maus mit einem Rahmen
  152.                     und zeigt dessen Typ und Index in der Infozeile des
  153.                     Fensters an.
  154.  
  155. CTRL-Einfachklick   Schaltet die Selektierung des Objektes unter der Maus
  156.                     um, d.h. war es vorher selektiert, so ist es an-
  157.                     schließend nicht mehr selektiert und umgekehrt.
  158.  
  159. @symbol i "Objekt verändern"
  160. @symbol i "Farben ändern"
  161. @symbol i "Muster ändern"
  162. @symbol i "Rand ändern"
  163. Doppelklick         Öffnet den Flags-Editor; hier können fast alle
  164.                     Eigenschaften der verschiedenen Objekt-Typen
  165.                     verändert werden:
  166.                     · ob_state: Schatten, Selektiertheit etc.
  167.                     · ob_flags: 3D-Flags, Verhalten bei Klicks etc.
  168.                     · ExType: erweiterter Typ
  169.                     · Innen/Rand/Text: Farben des Objektes
  170.                     · Bild/Maske: Farben der Grafik
  171.                     · Muster: Schraffierung des Objektes
  172.                     · Rand: die Dicke des Randes eines Objektes
  173.                     · Char: Zeichen bei Icons und Boxes
  174.                     · Transp./Replace: Text durchscheinend oder nicht
  175.  
  176.                     Wird der Dialog mit OK verlassen, so werden die
  177.                     Änderungen im Fenster sofort sichtbar, RscView eignet
  178.                     sich also auch in der Freeware-Version gut zum
  179.                     Experimentieren.
  180.  
  181. @symbol i "Zeichenketten verändern"
  182. CTRL-Doppelklick    Öffnet den String-Editor, sofern das selektierte
  183.                     Objekt eine Zeichenkette beinhaltet. Unter MagiC ist
  184.                     das Editfeld scrollbar, sofern der String zu lang ist,
  185.                     um in das Editfeld zu passen.
  186.                     Strings können hier nicht verlängert werden, so daß
  187.                     gerade beim Ändern fremder RSC-Files selbst dem Laien
  188.                     keine Fehler unterlaufen können.
  189.  
  190. @symbol i "Verschieben"
  191. @symbol i "Größe ändern"
  192. Maustaste halten    Objekte verschieben oder ihre Größe ändern, je
  193.                     nachdem, ob das Objekt in seiner rechten unteren Ecke
  194.                     angefaßt wird oder woanders.
  195.                     · Wird beim Anfassen die CTRL-Taste gehalten, so
  196.                     bezieht sich die Aktion nicht auf das Objekt unter der
  197.                     Maus, sondern auf das darunter liegende.
  198.                     · Wird die Maustaste losgelassen, so wird das ver-
  199.                     schobene Objekt an der neuen Position gerastert ab-
  200.                     gelegt bzw. dessen Göße an die des Gummibandrahmens
  201.                     gerastert angepaßt.
  202.                     · Ist beim Loslassen der Maustaste die Alternate-
  203.                     Taste gedrückt, so verbleibt das Objekt an seiner
  204.                     alten Position.
  205.                     · Ist beim Loslassen der Maustaste die CTRL-Taste
  206.                     gedrückt, so unterbleibt das Rastern, und es wird
  207.                     pixelgenau positioniert; dabei ist zu beachten, daß
  208.                     so positionierte Objekte bei Verwendung eines Zeichen-
  209.                     satzes anderer Größe nicht unbedingt an ihrer Position
  210.                     verbleiben, so das es zu sehr unschönen Effekten kommen
  211.                     kann.
  212.                     · RscView achtet beim Verschieben von Objekten darauf,
  213.                     das sie dabei ihr Vater-Objekt nicht verlassen, nicht
  214.                     korrigiert werden Überschneidungen von Objekten, denn
  215.                     das kann ja erwünscht sein.
  216.                     · RscView korrigiert Größenveränderungen derart, daß
  217.                     Objekte nicht aus ihrem Vater-Objekt hinausragen
  218.                     können und verhindert, daß Vater-Objekte so verkleinert
  219.                     werden, daß eines oder mehrere ihrer Kinder
  220.                     anschließend nicht mehr vollständig innerhalb des
  221.                     Vaterobjektes liegen.
  222.                     Nicht korrigiert werden Überschneidungen mit anderen
  223.                     Objekten (gleiche Begründung wie oben).
  224. @endnode
  225.  
  226. @node "Hinweise"
  227. @{U}Hinweise                                                              RscView@{0}
  228.  
  229. · Einschalten von 'Hidetree' ist derzeit irreversibel, d.h. ein einmal
  230.   verstecktes Objekt kann mit RscView nicht wieder sichtbar gemacht
  231.   werden.
  232. · Ein Iconeditor ist nicht geplant ;-)
  233. · Vor dem Verändern fremder Resourcen bitte unbedingt eine Sicherheits-
  234.   kopie des RSC-Files anfertigen, man kann nie wissen, auf welche Ver-
  235.   änderungen das zugehörige Programm verärgert reagiert!
  236. · evtl. im RSC-File enthaltene USERDEF-Objekte werden ersatzweise als
  237.   Rechteckte mit abgerundeten Ecken gezeichnet, da RscView ja nicht weiß,
  238.   was tatsächlich zu zeichnen ist.
  239. · Als Werte zur Rasterung werden derzeit die des "normalen" Systemfonts
  240.   (also (8, 16)) benutzt, bei entsprechender Resonanz ändere ich das aber
  241.   noch.
  242. @endnode
  243.  
  244. @node "History"
  245. @{U}History                                                               RscView@{0}
  246.  
  247. @{B}V1.01 -> V1.02:@{0}
  248. · Vertipper entfernt der bewirkte, daß pro Programmstart nur einmal
  249.   gespeichert werden konnte.
  250. · Beim Verschieben von Objekten nimmt der Rahmen immer exakt die
  251.   Position ein, an der das Objekt beim Loslassen der Maustaste abgelegt
  252.   werden würde (er springt also auf dem Raster); gleiches gilt für das
  253.   Vergrößern/Verkleinern von Objekten.
  254. · Workaround für den häßlichen schwarzen Kasten bei selektierten [C]ICONs
  255.   ohne Textfahne eingebaut, solche Icons einfach mal CTRL-Doppelklicken :-)
  256. · Die Farb-Popups sind jetzt auch in S/W benutzbar, da sie nun Farbe und
  257.   Text enthalten
  258.  
  259. @{B}V1.00 -> V1.01:@{0}
  260. · CTRL-Cursor Links/Rechts zum Blättern durch die Bäume eingebaut für die
  261.   armen Schlucker, die sich keinen 10er-Block an der Tastatur leisten
  262.   können ;-)
  263. @endnode
  264.  
  265.  
  266. @pnode %thickness
  267. @alias "Dicke des Randes"
  268. Dabei bedeuten negative Werte, daß der Rand ins
  269. Innere des Objektes gezeichnet wird, 0 bedeutet
  270. kein Rand und bei positiven Zahlen wird der Rand
  271. nach außen verdickt.
  272. Einstellbar sind Werte zwischen -4 und 4.
  273. @endnode
  274.  
  275. @pnode %pattern
  276. @alias "Transp./Replace"
  277. Wird der Modus 'Replace' gewählt, so bekommen die
  278. Zeichen einen weißen Hintergrund, während im
  279. Modus 'Transparent' die Farbe des Hintergrundes
  280. durchscheint.
  281. @endnode
  282.  
  283. @pnode %ExObType
  284. @alias "ExType"
  285. Dieser Wert wird vom Betriebsystem nicht genutzt,
  286. kann also vom Programmierer für eigene Zwecke
  287. verwendet werden; da die Folgen einer Änderung
  288. von RscView nicht vorhergesgt und somit auch
  289. nicht korrigiert werden können, ist hier
  290. besondere Vorsicht geboten.
  291. @endnode
  292.  
  293. @pnode %boxcol
  294. @alias "Innen/Rand/Text"
  295. Diese Attribute stehen bei Objekten vom Typ
  296. G_TEXT, G_FTEXT, G_BOXTEXT, G_FBOXTEXT,
  297. G_BOX, G_IBOX und G_BOXCHAR zur Verfügung.
  298. Gewählt werden kann aus den 16 Systemfarben,
  299. steht eine Farbe in der aktuellen Auflösung
  300. nicht zur Verfügung, so wird schwarz verwendet.
  301. @endnode
  302.  
  303. @pnode &icncol
  304. @alias "Bild/Maske"
  305. Diese Attribute stehen bei Objekten vom Typ
  306. G_IMAGE (nur Bildfarbe), G_ICON und G_CICON
  307. zur Verfügung.
  308. Gewählt werden kann aus den 16 Systemfarben,
  309. steht eine Farbe in der aktuellen Auflösung
  310. nicht zur Verfügung, so wird schwarz verwendet.
  311. @endnode
  312.  
  313. @pnode %obchar
  314. @alias "Char"
  315. Eingestellt werden kann hier das einzelne Zeichen von
  316. Icons, bekannt z.B. in den Laufwerks-Icons auf dem
  317. Desktop bzw das in G_BOXCHAR darstellbare Zeichen.
  318. @endnode
  319.  
  320. @pnode %stateflags
  321. @alias ob_state
  322. @alias ob_flags
  323. Die kleinen Buttons mit den Zahlen am unteren Ende der
  324. jeweiligen Spalte kennzeichnen die Bits ohne offizielle
  325. Bedeutung, sie werden von den Programmen und auch von
  326. Systemerweiterungen für eigene Zwecke verwendet, Ver-
  327. änderungen dieser Bits sollten also nur bei genauer
  328. Kenntnis der Auswirkungen vorgenommen werden.
  329. @endnode
  330.  
  331.  
  332.